All DatabasesInside Mac - Basic Toolbox
DisposHandle
DisposHandle Free allocation created via NewHandle
#include <Memory.h> Memory Manager
void DisposHandle(theHandle );
Handle theHandle ; Handle leading to data to discard
DisposHandle releases into the heap all storage allocated for the specified
Handle. The value of the handle becomes invalid.
theHandle is a handle leading to some data. It is generally a value obtained via
NewHandle. Upon return, theHandle still points to a master
pointer, but it MUST NOT BE USED again, unless a new value is
assigned to it first (i.e., by a subsequent call to NewHandle).
Returns: none; the MemError function may return one of:
noErr (0) No error
memWZErr (-111) Illegal operation on a free block
Notes: Use this to free up a data area you no longer need.
After the call, theHandle (and ALL DUPLICATES, if any) will still point to
a master pointer, but the master pointer may not point to a block of data.
You are free to use theHandle in a subsequent call to NewHandle.
Referenced by (68):